GOM IEA Meeting
New Orleans, LA
Jan 2023
Git is software that does file versions and bookkeeping.
GitHub is an online collaborative platform using Git
Users: Each person makes their own GitHub account
Organizations: Individual accounts can be added to organizations for collaborative projects
Repos (Repositories)
Folders that contain files like data, code, reports, images, formatting files, read me etc.
Can be in a personal account or in an organization’s account
Can tag/assign to people within the thread
Timeline of actions included in thread
Notifications go to those tagged or whoever has notifications on
Can add to projects
Publish Websites
Automatically update reports/websites for up-to-date results
Commits
Commits are how someone edits or changes the files in the repo
Each new commit is tracked so that previous versions can be accessed
Quarto is a file format (.qmd) that is the next evolution to R Markdown files.
Allows you to create, convert, and publish documents, presentations, websites, books and more.
Allows you to switch between Source and Visual view while creating
Allows you to switch between Source and Visual view while creating
Update reports/documents/presentations by rerunning code with new data or automating data retrieval
Host newest versions of reports on GitHub immediately with same link so always receiving updated version
Built in version control
Organization members can submit edits easily in GitHub and can be reviewed by other members
Formats are not only useful for final products (websites, papers, etc.) but also for sharing code and results while working through a project
If you are already using these tools (or similar) what do you find works best and would be most useful to the work we are doing?
What are the barriers for you and your colleagues to adopt this workflow?
What are some solutions to these barriers?
How do we organize our workflow to make it more cohesive across groups and projects?
How can we make our meetings more efficient?